		    BIKLOG5    V 2.3
********************************************************
*        For the Psion Series 5 and 5mx.               *
********************************************************

(Copyright,  Jaap Lamris. Januari 2000)

INTRODUCTION
============

BIKLOG5 is a program made for bicyclists who like to keep
track of their bicycle rides during time. It is not meant
to be used during the ride as a cycle computer but as an
extension of it to store the cycle computer data and as
a tool to analyse the bicycle rides over time.

With some renaming of the definitions of the type of bicycles
used and riding type, it may be used even for thriathletes by
renaming the bicycle names in "swimming", "biking", and "running"
and adapting the bicycle ride names into appropriate terms like
"training", "race", "intervals" etc.

This program is based on the original program Biklog3,
which was my first major attempt at programming in OPL.
It was then completely developed on my Series 3a with the
aid of the S3a emulator. When I later purchased a S5,
I ported it to the Series 5 and extended it with the
additional capabilities of the S5 (namely, pen operation,
printing capabilities and a better database management).
In version V2.1 I have included some more options,
more statistical output and a way to keep track of the
rides ridden versus a goal set for # of rides and bicycle
distance set for the year.

I have tried to make the program to be user friendly as far
as possible, and have released it after a long period of
using it myself (during more than a year).

This program is freeware, not because I don't need the
additional income or fancy the merits of this program, -
I spent a large amount of time and effort in creating and
debugging this program -, but charging for something I wrote
as a hobby and for fun is not my style. Further by making it
freeware (or better said postcardware, see the section
REGISTERING) I will not be forced to spent considerable time
in maintaining and supporting it just for the sake of getting
a small additional income. That doesn't mean that I will not
support it anymore. As an user of BIKLOG5 myself and as a
perfectionist by nature I will keep improving the program and
supporting any users of it. Another reason to release it as
freeware are some bad experiences in the past with shareware
(PSION and PC) programs for which I paid the registration,
after which the author did not support it any more, released
it as freeware or kept charging for updates despite his
earlier promises... .


INSTALLATION
============
Below is a list if files supplied in the distribution ZIP
file (The file biklg523.ZIP) and the directories
they should be placed in after the installation.

biklog5.sis                         SIS installation file
biklog5.txt                         this file

If using Psiwin 2.x within windows then just click on the biklog5.sis
file. The program will appear in the "normal" Extras Bar after the
installation. Alternatively, you may copy the BIKLOG5.SIS to your EPOC
machine and double tab it. If installing from somewhere other than
Windows then you will need to obtain INS_TE.EXE and install that on
your EPOC32 machine. This will enable .SIS files to be decoded using
the EPOC32 machine.

After installation you should have on your machine the following files:
* = C or D
*:\system\app\biklog5\biklog5.APP       Main application file.
*:\system\app\biklog5\biklog5.AIF
*:\system\app\biklog5\biklog5.MBM
*:\system\app\biklog5\biklog5.HLP       BIKLOG help file.
c:\system\app\biklog5\bike.ini          default configuration file
*:\biklog\example                       example database
c:\system\app\biklog5\example.ini       example configuration file

Except for the *.ini files, all other files may be located on the
C or D drive. The database files may be located in any (sub)directory,
(from V2.2 on). The directory "*:\biklog\ " is recommended to be the
location for the database file.


USAGE
=====

Most of the information you may need on how to use
BIKLOG5 is included on the on-line help.

Here is a short description of all hot-key presses

Ctl-O    Open existing file
	   - Always required, except when creating a new file. Enter
	   filename or use TAB or cursor to cycle through existing
	   files

Ctl-N    Create a new file
	    - After entering the name and location of the new file,
	   you will be asked to enter the names of up to four
	   bicycles in your household, and the type of bicycle rides
	   you want to tag to your rides (like commute, training,
	   race, clubride). Maximal five ride definitions are possible.

Ctl-C    Close the current file
	   - Only needed if you want to switch to another database file,
	   or to delete the current file.

Shft-Ctl-D    Delete a file

Shft-Ctl-S    Sort current file
	   - This will sort the records according to ascending date.
	   The plotting option assumes that the records are sorted by date!
	   If you get strange effects with the graphs, just do a sort.

Ctl-A    Add a record
	   - Here you enter the date, bicycle name, bicycle ride type, distance,
	   time or average speed and a short descriptions (max. 40 characters)
	   of the ride. By default the current date and the values of the last
	   entered record will be entered. You may choose to enter average speed
	   or time. Either one is sufficient.

Ctl-S    scan records
	   - Here you will see a listing of all rides present in the database,
	   according to the filter settings set after entering this mode
	   (time period and bicycle type).  All the filtered records will be
	   listed line by line. Use the cursor up, down, and the PgUp or PgDn
	   keys to move or scroll up or down, respectively.
	   HOME or END will move to the first or last record. ESC will exit the
	   scan mode, while "s" will present some statistics of the data
	   in the database. Any other key will invoke a listing of possible
	   actions.


Shft-Ctl-A    Alter a record

Shft-Ctl-E    Erase a record

Ctl-F    Find a string in the records
	   -Use this option to find a string in the memo field of one or more
	   records

Ctl-G    Plot the (cum.) distances per bicycle or ride type
	   -You will be prompted to enter starting and ending date of the time
	   period, and the time unit along the x-axis (day, week or months).
	   By default the starting date will be January 1th of the year of the
	   first record, and the ending date will be the current date.
	   Cumulative distance plots will be presented for each of the available
	   bicycles (with more than 0 km) in the database plus all bicycles
	   together. Use the up and down cursor keys to cycle through the plots,
	   ESC will return to the menu. Each other key will invoke a listing
	   of possible actions.

Ctl-V    Preferences settings
	   -use this option to customise the bicycle names, ride definitions,
	   unit of distance (kilometer or mile), and the goals in terms of
	   number of kilometers or miles and the number of rides set in a year.
	   A message wil show up when each goal has been reached.

Ctl-I    Info on program

Shft-Ctl-H    Help function

Ctl-T    Statistical description of rides
	   -Four tables will show you some common statistics (# of rides,
	   cumulative and mean distances and duration for each bicycle and
	   ride type in the database, absolute and relative to the total
	   bike rides. Additionally the total distance ridden per month
	   and bicycle type is shown, while the last table will present
	   some statistics of the rides (longest, shortest, fastes and
	   slowest)

Ctl-E    Exit

Ctl-U    UPGRADE from older versions
	   From version 2.3 on the datafile created in BIKLOG5 is an
	   official BIKLOG5 document, enabling to immediately open
	   this file by double tabbing on the icon of the datafile.
	   UPGRADE will convert old datbasefiles, to be recognized by
	   a question mark, to BIKLOG5 documents. A backup file with
	   the extension ".bak" will be created in the original directory.

In addition the printing option lets you invoke the regular Psion 5
printing mode. Please note that you must have invoked first the scan mode
to be able to print the tabular data. At this moment only the tabular
data of the scan option is possible to print. For printing the plots or
the other statistics, use the print screen option: (Shft-Ctl-Alt-S) to make
a regular MBM file.

I do recommend that you use the online help, at least until
you become familiar BIKLOG5.


Future Improvements
===================

-- The scroll bar feature is not really working well and needs some
   improvement.
-- More plotting options.
-- Adaption for thriathletes (is already possible in rudimentory form by
   renaming the bicycle names in "swimming", "biking", and "running" and
   adapting the bicycle ride names into appropriate terms like "training",
   "race", "intervals" etc.
-- Anything you as user will suggest that is worthwhile and shared at least
   by one other user!

ACKNOWLEDGEMENTS
================

Thanks to Jezar for providing the Help generator, Neil K Bee (neil@bee.net)
for the use of one of his icons, and all other PSION programmers, especially
Steve Litchfield and Al Richey with their RMREVENT program, who gave me
examples of goord working programs.



REGISTRATION
============

WHY REGISTER ?

Although BIKLOG5 is freeware, I would be very happy if you let me know that
you are going to use my programme. First of all to satisfy my curiosity, after
putting numerous hours and effort in writing and debugging this program.
Secondly it will encourage me to continue further with this program and
extend it if you indicate a need for this. Thirdly I will be able to keep
you informed on next releases of BIKLOG5, if you registrate it by me.


HOW DO I REGISTER ?
Preferably you can send your name, adress and/or Email adres
by Email to:

Jaap Lameris
lamerisj@hotmail.com

Else you can send a postcard to:

Jaap Lameris
Richel 10
8303 KX EMMELOORD
Netherlands.

Please include in your registration note,  the version number you got,
your postal adress and Email adress.

Additional information on BIKLOG5 will be also available on my homepage:

http://Jaap_Lameris.tripod.com/mypsion.htm


DISCLAIMER
==========
Use this software at your own risk. I will not be held
responsible for any loss of data and/or any damage caused
to users or hardware caused by this software.



COPYRIGHT AND CONDITIONS
========================
I reserve copyright on this material, any reproduction in
part or whole is strictly prohibited. Additionally,
reverse translation of any of files included in the file
"BIKLG523.ZIP" is strictly prohibited.

You are permitted to distribute the file "BIKLG523.ZIP",
as widely as you see fit, under one condition. That
condition being; That the file is not in any way altered,
and is sent on in an unchanged state.



FEEDBACK
========
If you have any comments or suggestions for me I would be
pleased to hear from you ! You can mail me at the above
address or you can email me at these email addresses;

		 lamerisj@hotmail.com
			  or
		   lameris-molhoek@hetnet.nl

Now get on and start bicycling !!!


HISTORY
=======
Version 2.3 (Jan. 16, 2000):
The duration of single rides in the SCAN and STATISTICS modes is now being
expressed as hours:minutes format. The datafile generated by BIKLOG5 is now a
BIKLOG5 document, e.g. the datafile can be opened automatically in BIKLOG5 by
double tabbing on the icon of the database file. An upgrade module is provided
in BIKLOG5 to convert databases generated with earlier versions to BIKLOG5
document. A backup file with extension ".bak" will be generated.

Version 2.2.1 (Dec. 21, 1999):
Minor bugs fixed. It is now possible to use any directory name to place your
datafile. Also it is now possible to enter riding time in hours + minutes.

Version 2.1 (Nov. '99):
Major upgrade from original version.

Version 2.0 (Aug. '99), original version, not published in public domain:
Based on the original Series 3 version (Biklog3 V 1.1).



